Waverider Systems
http://www.WaveriderSystems.com

Perlshop 4 State Recorder Plugin
Version 1.0


This plugin requires Perlshop 4.4.00 or later.  

--------------------------------------------------------------------------------------
Overview:

This plugin records the contents of the Perlshop 4 %input data structure.
The contents are recorded in a text file.  Each line in the text file represents
one member of the data structure.  Each member is expressed as a Name-Value pair.

This plugin is intended for use by developers who are writing their own plugins.
The state values recorded by this plugin can be referenced by other custom plugins
used later on during the lifecyle of an order.


--------------------------------------------------------------------------------------
Installation Procedure:
1.	Place the PS_Record_NV.pm file into the same web server directory as your perlshop.cgi file.

2.	Give the PS_Record_NV.pm file the same file permissions as your perlshop.cgi file.

3.	Add the plugin to the plugin registration table in your ps.cfg file.

Example plugin registration table before adding the plugin:
%plugins =
(
    # Calendar example plugin
    'calendar' => 
    {
        'program' => 'ps_plugin_gencal.pl'
    }
);


Example plugin registration table after adding the plugin:
%plugins =
(
    # State recorder plugin
    'record_nv' =>
    {
        'module'       => 'PS_Record_NV.pm',
        'event'        => 'before_submit_customer|after_place_order',
        'display'      => 'no',
        'subdirectory' => 'record_nv',
        'delete'       => 'after_place_order'
    },

    # Calendar example plugin
    'calendar' => 
    {
        'program' => 'ps_plugin_gencal.pl'
    }
);


--------------------------------------------------------------------------------------
Using the State Recorder plugin:

Once installed, this program will be automatically used by Perlshop.  No catalog page modifications are required.